<figure>: Das Figure-Element mit optionaler Beschriftung
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Das <figure>
HTML-Element repräsentiert eigenständige Inhalte, möglicherweise mit einer optionalen Beschriftung, die mit dem <figcaption>
-Element angegeben wird. Die Figur, ihre Beschriftung und ihre Inhalte werden als eine Einheit betrachtet.
Probieren Sie es aus
<figure>
<img
src="/shared-assets/images/examples/elephant.jpg"
alt="Elephant at sunset" />
<figcaption>An elephant at sunset</figcaption>
</figure>
figure {
border: thin #c0c0c0 solid;
display: flex;
flex-flow: column;
padding: 5px;
max-width: 220px;
margin: auto;
}
img {
max-width: 220px;
max-height: 150px;
}
figcaption {
background-color: #222;
color: #fff;
font: italic smaller sans-serif;
padding: 3px;
text-align: center;
}
Attribute
Dieses Element enthält nur die globalen Attribute.
Verwendungshinweise
- Ein
<figure>
ist in der Regel ein Bild, eine Illustration, ein Diagramm, ein Code-Snippet usw., das im Hauptteil eines Dokuments referenziert wird, aber an eine andere Stelle des Dokuments oder in einen Anhang verschoben werden kann, ohne den Hauptfluss zu beeinflussen. - Eine Beschriftung kann dem
<figure>
-Element zugeordnet werden, indem ein<figcaption>
innerhalb davon eingefügt wird (als erstes oder letztes Kind). Das erste<figcaption>
-Element, das in der Figur gefunden wird, wird als Beschriftung der Figur präsentiert. - Das
<figcaption>
bietet den zugänglichen Namen für das Eltern-<figure>
.
Beispiele
Bilder
html
<!-- Just an image -->
<figure>
<img src="favicon-192x192.png" alt="The beautiful MDN logo." />
</figure>
<!-- Image with a caption -->
<figure>
<img src="favicon-192x192.png" alt="The beautiful MDN logo." />
<figcaption>MDN Logo</figcaption>
</figure>
Ergebnis
Code-Snippets
html
<figure>
<figcaption>Get browser details using <code>navigator</code>.</figcaption>
<pre>
function NavigatorExample() {
let txt = `Browser CodeName: ${navigator.appCodeName};\n`;
txt += `Browser Name: ${navigator.appName};\n`;
txt += `Browser Version: ${navigator.appVersion};\n`;
txt += `Cookies Enabled: ${navigator.cookieEnabled};\n`;
txt += `Platform: ${navigator.platform};\n`;
txt += `User-agent header: ${navigator.userAgent};`;
console.log("NavigatorExample", txt);
}
</pre>
</figure>
Ergebnis
Zitate
html
<figure>
<figcaption><b>Edsger Dijkstra:</b></figcaption>
<blockquote>
If debugging is the process of removing software bugs, then programming must
be the process of putting them in.
</blockquote>
</figure>
Ergebnis
Gedichte
html
<figure>
<p style="white-space:pre">
Bid me discourse, I will enchant thine ear, Or like a fairy trip upon the
green, Or, like a nymph, with long dishevelled hair, Dance on the sands, and
yet no footing seen: Love is a spirit all compact of fire, Not gross to
sink, but light, and will aspire.
</p>
<figcaption><cite>Venus and Adonis</cite>, by William Shakespeare</figcaption>
</figure>
Ergebnis
Technische Zusammenfassung
Inhaltskategorien | Flussinhalt, greifbarer Inhalt. |
---|---|
Zulässige Inhalte |
Ein <figcaption> -Element, gefolgt von
Flussinhalt; oder Flussinhalt gefolgt von einem
<figcaption> -Element; oder Flussinhalt.
|
Weglassen des Tags | Keine, sowohl das Start- als auch das End-Tag sind obligatorisch. |
Zulässige Eltern | Jedes Element, das Flussinhalt akzeptiert. |
Implizierte ARIA-Rolle | figure |
Zulässige ARIA-Rollen | Ohne figcaption-Nachkommen: any, ansonsten keine erlaubten Rollen |
DOM-Interface | [`HTMLElement`](/de/docs/Web/API/HTMLElement) |
Spezifikationen
Specification |
---|
HTML # the-figure-element |
Browser-Kompatibilität
Siehe auch
- Das
<figcaption>
-Element.